Moves a file or directory from one directory to another directory.

OSErr PBMoveObjectSync (
    FSRefParam *paramBlock
);

paramBlock

A pointer to a parameter block.

function result

A result code.

DISCUSSION

The relevant fields of the parameter block are:

• ioCompletion

  On input, a pointer to a completion routine.

• ioResult

  On output, the result code of the function. If destDirectory specifies a non-existent object, dirNFErr is returned. If destDirectory refers to a file, then errFSNotAFolder is returned. If destDirectory is on a different volume than ref, diffVolErr is returned.

• ref

  On input, the file or directory into which to move the file or directory specified in the ref field.

• newRef

  On output, a new FSRef for the file or directory in its new location. This parameter is optional and may be set to NULL.

AVAILABILITY

Supported in Carbon. Available in Mac OS 9, and later when Carbon 1.0.2 or later is present.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)